Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / zip82c.arc / ZIP.DOC next >

Wrap

Text File | 1985-07-13 | 29.8 KB | 685 lines

---------------------------------------------------------------- ZIP - Integrated File Handler Package - Version 0.7 ---------------------------------------------------------------- An All-purpose Directory Utility and Command Shell for the IBM Personal Computer & Close Compatibles By Edward V. Dong July 08, 1985 Copyright (c) 1985 by Edward V. Dong. All rights reserved. ---------------------------------------------------------------- 1.0 INTRODUCTION The ZIP program is an integrated file handling utility package, written mainly in DeSmet C version 2.3 for PC/MS-DOS 2.0 or later, with some assembly language subroutines embedded. The following is a brief summary of functions currently supported: o Sorted directory, showing hidden, read-only, system files. o File attribute read/set, to hide/unhide files, etc. o View text files, standard ASCII. o View WordStar files in addition to standard ASCII. o Edit text files, with limited screen editing capabilities. o Hexadecimal/ASCII dump of files. o Copy/print/delete multiple files. o Rename files. o Squeeze/unsqueeze files. o Library functions: list libraries, extract members. o Add members to existing libraries; create libraries. o Ability to execute files (.BAT, .COM, .EXE). o 300/1200 BPS ASCII/Xmodem telecommunications. The following are additional features that may be added in the future. o Label disks. o Auto-catalogue files to master directory, with comments. ZIP version 0.7C is currently distributed as "User Supported Software", under the "FreeWare" or "ShareWare" concepts. With a few restrictions, this allows the program, although copyrighted, to be freely copied and distributed. Version numbers less than 1.0 are beta test versions, where user comments and testing are solicited. When sufficient testing (and fixes and/or upgrades) has been completed, the version will go to 1.0 or higher. Whole numbers will indicate a significant upgrade or revision, while fractional numbers will indicate minor upgrades or bug fixes. The current version number is identified in the top line of the ZIP display as a decimal number enclosed in brackets, e.g., [0.7]. When followed by the letter "C", the version number indicates a version done in the "C" language; else indicates a version done in Turbo Pascal. Version history is as follows: o Version 0.0 - original beta version. o Version 0.1 - Edit bugs fixed; disk label bug fixed. o Version 0.2 - add capability to execute files or manual commands as if entered from DOS prompt line. o Version 0.3 - add print capability; show number of files which are tagged; additional error checking; verify option on copy. o Version 0.4 - added new Edit/View options; copy, squeeze, unsqueeze now run much faster; added basic telecommunications capability. o Version 0.5C- previous versions written in Turbo Pascal 2.0; revisted/translated to "C", DeSmet ver. 2.3. Edit not supported yet under C; view is more basic. Library functions expanded to include library creation & add/update library members. o Version 0.6C- View now supports string search, paging, and automatically strips high-order bit, thus allowing WordStar file browsing. Telecom expanded to handle some non-Hayes modems. ZIP LBR files now compatible with LUT, LUE, LUU, and LAR, and with some versions of LU86. ZIP will show LBR member file date & time, if available. Copying speed increased 16 times. o Version 0.7C- Screen editing now supported. When all bugs have been exterminated, the version level will then become 1.0. Help me to do that! 1.1 WARRANTY & GUARANTEE. There aren't any, implied or otherwise. The author is not responsible for possible consequent damages arising out of the use of ZIP under any circumstances whatsoever. Remittance or contribution shall not provide for any warranties or guarantees of performance or against consequent damages, implied or express or otherwise. 1.2 DISTRIBUTION & COPYING. ZIP may be freely used, distributed, and copied, as long as ZIP is only for personal (not commercial) use; and that this product must be copied and distributed as a complete package. This includes both the ZIP program (ZIPxxx.EXE) and this documentation file (ZIPxxx.DOC), where xxx is the current version number. ZIP is copyrighted and may not be distributed if altered or modified in any way. Finally, no fee is to be charged for copying or distributing the programs without the written permission of the author; and commercial users should remit the $10 contribution (or actually "fee" in this case), to avoid possible legal hassles. In short, ZIP may be copied and distributed to anyone who wishes it as long as it is a complete unmodified package including the program and documentation and no fee is charged; and freely used except in a commercial environment. In turn, a small contribution of about $10.00 is suggested but please contribute whatever you feel the program is worth. Your contributions will help offset development costs and thus assure future updates and products. However, for the contribution of $35, a DSDD disk will be sent, containing the latest version of the program, documentation, and complete source files. Even if you don't feel that the program merits a contribution, please continue to copy and share this program with others. Edward V. Dong 12205 Alexandria Place Chino, California 91710 1.3 REQUIRED CONFIGURATION ZIP needs the following environment: 1. IBM PC or close clone 2. Color Graphic screen adapter 3. MS/PC-DOS 2.0 or 2.1 4. At least 128K (256K is recommended) For best results, you should set CONFIG.SYS to "Files = 15" and "Buffers = 16", or greater. Consult your DOS manual for details on the setup of CONFIG.SYS. The "Buffers" statement will speed up disk accesses, especially when dealing with floppy drives. ZIP won't run properly on a PCJr, because display memory organization is different on a PCJr. (Recent note: I have been informed that ZIP will display properly on a PCJr, but has some problems handling disk directories.) Since I don't have access to EGA or to an AT, there is no guarantee that ZIP will run on an AT or an EGA device. If there is a demand for the use of ZIP on the PCJr, or EGA/AT, special versions will be written. ZIP should run under MS-DOS 2.11 or later. For speed, however, of display generation, ZIP has been customized to an IBM-PC, so it may not run on some PC clones which do not support the same display generation capabilities. ZIP makes use of color, and assumes a color/graphics adapter. ZIP does run on a color PC-3270 -- ZIP makes NO use of any true graphics, and only assumes a color alphanumeric setup, with display memory at B8000H. This means that green/amber screen monitors and IBM-style monochrome monitors cannot be used with ZIP. Again, if there is a demand for ZIP on these devices, special versions will be written. 1.4 BUG REPORTS & OTHER COMMENTS. Address bug reports and other comments (praise won't be unwelcome, of course; naturally, the highest praise being ca$h) to the above address. E-Mail may be addressed at the present time to me ("Edward Dong") via: Rod Bowman's "PC-Spectrum" IBMPC-RBBS Chino, California 714-980-8607, 300/1200/2400 baud, 24 hrs/day. Matt Zilmer's FIDO Claremont, California 714-626-1843 300/1200/2400 baud, 24 hrs/day. 2.0 USING ZIP VERSION 0.7C All you have to do is type in: ZIP. A help screen is provided as a quick summary of the available functions. A brief discussion of these functions follows. 2.1 Directory ZIP immediately displays the sorted directory for the current drive, showing all files, including hidden, read-only, and system, as well as directory and volume-label files. The current attribute is shown next to the file name; however, for space considerations, only one attribute is shown at a time. These are: h(idden), r(ead-only), s(ystem), d(irectory), and v(olume-label). By hitting ENTER when a high-lighted file is a d(irectory), ZIP will put you into that directory, and then display the contents of that directory. If you want to change drive, enter L for Login to new drive; ZIP will prompt for the new drive/directory. When entered, the sorted directory for the new drive/directory, will be displayed. NOTE: If you then chose to exit ZIP after Login, you will be in that drive and/or directory. PgDn and PgUp can be used to scroll through the directory, if the total directory cannot be fitted to the current CRT window. NOTES: A simple sorting function was previously used in ZIP, so it was rather slow for those systems with more than 50-60 files. This has been corrected in the "C" version, using Quick Sort. The previous Pascal version used software floating point for calculation of file sizes larger then 32767, which also made it slower; happily, "C" supports LONG integers, so this has gone away. 2.2 File Attributes As you may or may not know, DOS generally marks each file with one or more attributes. These are: o A(rchive): If set, means this file has not been backed up. o D(irectory): If set, means that this file constitutes a subdirectory with or without files in that subdirectory. o V(olume): If set, means that the filename is the label for the disk in the current drive. o S(ystem): If set, means it is a system file, like a device driver. o R(eadonly): If set, means that the file cannot be deleted or modified. o H(idden): If set, means that the file cannot be normally listed, deleted, copied, or read. ZIP provides through the "F"(ile) command, the means to read the total set of file attributes (some can be combined), and to set these attributes. The "V" attribute is not modifiable, however. When ZIP displays the sorted directory for a drive, the highest priority file attribute is displayed (as a lower-case letter next to the file name). The A(rchive) attribute, however, is NOT displayed (except through the "F"(ile) command), as nearly all files in a directory will likely have this on. 2.3 Editing By using the cursor keys and/or PgDn/PgUp keys, you point to a high-lighted file shown on the directory display. Then at the command prompt (last line on the screen), enter "E". This will put you into a screen editing mode for the high-lighted file. A brief command line description appears at the bottom of the screen, indicating the type of editing you can perform. You can insert/delete lines; insert/delete characters; and scroll back and forth through the file. The complete scroll capability is provided only if the entire file can fit into the available memory. If you have not much memory, then only a portion of the file can fit. While screen editing of files is supported by ZIP, you can't use ZIP to create a new file to be edited. This will probably change in the next version of ZIP. ZIP editing, like EDLIN or IBM's Personal or Professional Editors, performs editing in memory. If the size of a file is larger than your available memory, the first segment of the file is loaded for editing. When you finish this segment, this segment is written to a temporary file called ZIP.$$$, and the next segment is loaded. Once a segment has been written to ZIP.$$$, and the next segment is loaded for editing, you CAN'T go back to an earlier segment. ZIP, when you have SAVEd your file, erases/deletes the original file, and then renames ZIP.$$$ to the original file name. ZIP DOES automatically make a backup copy of the original file name, with the extension .BAK. If another file of this name exists (*.BAK), it will be deleted and replaced. Editing files are limited to 78-character lines. If a file being edited is longer than 78 characters, the excess will NOT be displayed. The resultant SAVEd file, however, will have the full string -- you just cannot edit that portion of the line. ZIP isn't intended to replace your standard editor or word processor; if it did, ZIP would have to be twice as large. Beginning with beta version 0.4, EDIT supports the following commands: F1 - Display list of EDIT/VIEW commands. F2 - Find string, starting with current line to the end of the current segment loaded. F3 - Get/put -- writes current segment to disk, and fetches the next segment. F4 - Quit. Same as END. F5 - Insert new line (initialized to a single blank). F6 - Delete current line. HOME - Go to top of current segment. END - Save or quit current EDITed file & terminate. Additionally, the top line of the display shows current status of file, i.e., segment loaded, and number of total lines in that segment. NOTE: Tab characters (which are expanded under VIEW) are not expanded under EDIT. They will appear as strange-looking little circles. The reason for not performing the expansion is to show as much of the line as possible for EDITing. 2.4 Viewing By using the cursor keys and/or PgDn/PgUp keys, you point to a high-lighted file shown on the directory display. Then at the command prompt (last line on the screen), enter "V". This will put you into a full-screen browse or viewing for the high-lighted file. A brief command line description appears at the bottom of the screen, indicating the commands you can enter: PgUp, PgDn, HOME (to take you back to the top of the file), and END (to quit). Scrolling is limited to paging forward or backward. Pressing F2 invokes a string search function. ZIP will prompt for the string to find, and will attempt to find this string, searching the entire file if necessary. When the first occurrence is found, all occurrences of that string on the given display page will be highlighted. If you are past that displayed page, and wish to find the string again, press the letter A (upper or lower case). ZIP will search for the next occurrence of the string. Viewing files are limited to 80-character lines. If a file being viewed is longer than 80 characters, the excess will be lopped off and not displayed. Expressed another way, a file being viewed of length greater than 80 characters will be truncated to the first 80 characters. VIEW will automatically strip the high-order bit, so that WordStar files can be viewed without modification or conversion. Beginning with version 0.7C, VIEW will also automatically expand tab characters found into the appropriate number of blanks. ZIP assumes that tab's are meant to space every 8 characters, so if the file uses tab's to space a different number of characters, the display will look a little strange. 2.5 Squeezing/Unsqueezing By using the cursor keys and/or PgDn/PgUp keys, you point to desired files shown on the directory display. Then you press the space bar to "mark" or "unmark" the files. Finally, at the command prompt (last line on the screen), enter "S" for squeezing the file or "U" for unsqueezing ALL the marked files. As each file is SQueezed or UnSQueezed, the bottom line of the display will show the operation(s) as each file is processed. Beginning with version 0.7C, ZIP no longer opens a window to show the operation. 2.6 Library 2.6.1 Library List/Extract By using the cursor keys and/or PgDn/PgUp keys, you point to a high-lighted file shown on the directory display. Then at the command prompt (last line on the screen), enter "B" for liBrary functions. ZIP will open a new window, display the sorted directory for the library (LBR file), and generate a brief command line at the bottom of the screen. Available options are displayed if you press the "?" key. Beginning with version 0.65C, you can direct the extraction to another disk or directory, by pressing "C". ZIP will ask for the new disk/directory. To direct to C:\NEWDIR, for example, type C:\NEWDIR\ You MUST enter the second backslash. To direct to another drive, say, B:, type B: The colon is required. You can either Extract one or many LBR members, or Quit. To extract one or more members, use the cursor/PgDn/PgUp keys to point to each member, and then use the spacebar to mark/unmark the member for extraction. When finished with the marking, enter "E", and each file will be extracted in turn. ESC is accepted as Quit as well. If the LBR file has been created by ZIP 0.64 or later, or by any of Vern Buerg's LUU routines, ZIP will also show the creation date and time of the members of the LBR file. If you have extracted any members, ZIP will re-read the current drive and provide a new sorted directory listing display. 2.6.2 Library Create/Update You can create a library, and add members to this library, or to an existing library. To create a library or to add members to an existing library, you must first "mark" the files in the current directory to be added to that library. To create, point (via cursor and/or PgDn/PgUp keys) to any file in the directory which is NOT a library file. Then at the command prompt (last line on the screen), enter "A" for library Add-member functions. ZIP will ask if you want to create a library (because the current file is NOT a library file); and if so, will ask what name you want to give it. If it can be created, then ZIP will automatically add the files which you have marked, to that library. The library name can include optional drive and directory, to build an LBR on another disk and/or directory. You must then enter the COMPLETE file name for the desired LBR. To add members to an existing library, simply point to a file which IS a library file. Then proceed as above. That's all there is to it. 2.7 Copying/Printing/Deleting By using the cursor keys and/or PgDn/PgUp keys, you point to a high-lighted file shown on the directory display. Then you "mark" the file by using the spacebar. You toggle the "mark" off or on, with the spacebar. When finished with the marking, enter "C" for Copy, or "D" for Delete, or (beginning with beta version 0.3) "P" for Print. C(opy) will ask for the new drive/directory to which the files are to be copied to; with appropriate error messages sounded with a beep. Beginning with beta version 0.3, C(opy) will prompt for a VERIFY. The VERIFY uses DOS's verify function on disk writes. The VERIFY is either enabled or disabled for the multiple files "marked" with the spacebar. NOTE: When copying to a new drive, you can specify only the drive letter. ZIP will copy the file(s) to the root directory on that drive. NOTE: When copying to a new drive/directory or a new directory (the drive letter will default to the current Login disk drive), you MUST enter a second backslash (as explained under the Library functions). D(elete) will first prompt if you really want to perform the deletion, and then ALL the marked files will be deleted. There is NO undelete function in ZIP. P(rint) will print all marked files in sequence, automatically doing a page eject between file printouts. You can embed your printer's command codes into the files if you wish, but you have to do this with a non-ZIP editor or word processor. ZIP performs NO formatting. 2.8 Command/File Execution Beginning with beta version 0.2, ZIP supports the direct execution of a file (.BAT, .COM, or .EXE) by using the cursor, PgDn, PgUp keys to high-light a file present in the current displayed directory; and then entering "X" at the prompt. You can also enter a command as if from the DOS prompt, by entering "I" at the ZIP command line prompt. ZIP will then prompt for the DOS or other command you wish to enter. A carriage return, with no other keys struck, will take you immediately out of the DOS command mode, back to ZIP. ZIP will initiate the command or execute the file, as follows. The CRT will be cleared, the command or file executed, and then a prompt message will appear to take you back to ZIP. WARNING: ZIP uses COMMAND.COM as both a basic file loader (when you are using the "X" command) and DOS interpreter (when you are using the "I" command). ZIP will search the root directories in drives F through A (starting with F) to find COMMAND.COM. If this file is NOT there, ZIP won't be able to perform a DOS command. An error message will be generated, if it's not possible to execute the command or file. This will be because: (1) you don't have enough memory to run ZIP and to execute the file -- in which you have to Q(uit) ZIP to run that file; or (2) the file selected or command entered are not valid, legal executable file(s)/command(s). POSSIBLE GLITCHES: DOS may freeze up if there is not enough memory to execute the command, or if the command clobbers memory that does not belong to it. In these cases, a re-boot is needed. 2.9 Telecommunications Beginning with beta version 0.4, ZIP supports basic 300/1200 BPS ASCII/Xmodem telecommunications. To enter this mode, enter "T" at the ZIP prompt. NOTE: Beginning with ZIP 0.63C, ZIP will automatically switch to an alternate modem communications routine for certain non-Hayes modems. A brief message will be displayed when this occurs. The screen will clear, and then present a command summary for this mode in the upper part of the screen. You will be prompted for communications parameters to be set; ZIP will automatically set defaults to COM1 (communications port 1), 1200 BPS, No parity, 8 data bits, 1 stop bit, and local echo. Local echo causes everything you type to be "echoed", i.e., displayed. Turn the local echo off or on, via function key F9, if the remote host computer to whom you're communicating, uses full-duplex (i.e., the host will echo your inputs for you). WARNING: For this C version of ZIP, telecommunications presently is limited to COM1. Please do not try to use COM2. The command summary is fairly clear: o COLLECT TEXT allows you to capture ASCII (text) files or other text output from the remote host computer, into a file of your choosing. o SEND TEXT allows you to send text files to the remote host. However, ZIP does NOT implement "Pacing" characters in the mode of PC-TALK or QMODEM; and will send the file as fast as it can. o SEND XMODEM and RECEIVE XMODEM transfers files via the Xmodem/Checksum method, which is standard for most RBBS's. A window, set off in white on blue, will be generated, showing the Xmodem transaction. o RETURN TO ZIP suspends the telecommunications session, but does not hang up the telephone. You should still be on-line after you do whatever it was you wanted to do in ZIP, and return to telecommunications. o QUIT disables the selected COM port, and returns you to ZIP. You won't be on-line. In order to incorporate ZIP-TERM (ZIP's terminal telecommunications mode), ZIP does NOT provide the full features of CrossTalk, PC-TALK, or QMODEM, or any commercially available telecommunications program. You MUST use your modem's command set (such as ATDT <phone number> for a Hayes-compatible modem), if you have a smart modem. However, if you have a smart modem, an acceptable substitute for these functions is to SEND_TEXT for the commands particular to your modem. For Hayes and Hayes-compatible modems, remember that the text file sent must NOT have an embedded line feed character in it (i.e., decimal 10, or hex 0A), as this will be interpreted by the modem as a keyboard abort of the command string. Auto-dialing, redialing, hanging up, etc., are simply NOT supported, as are not pacing, translation, color/music graphics, etc. Color/graphics are supported if your system has installed ANSI.SYS (or equivalent), and if the remote host is using ANSI ESCape sequences. Music, however, whether or not ANSI.SYS is installed, is simply NOT supported. 2.10 Hexadecimal Dump Beginning with beta version 0.5C, ZIP provides a mainframe - style hexadecimal/ASCII dump of the current file. The contents of the file will be displayed in hexadecimal, 16 bytes per line, plus printable ASCII equivalents. If the byte cannot be displayed as a printable ASCII symbol, then it will be displayed as ".". 3.0 CREDIT WHERE CREDIT IS DUE The following describes where some of the features in ZIP originated. ZIP would not be possible except for various authors, known and unknown, who contributed their source code to the public domain. As a result, this section is dedicated to selfless programmers (CPM and MS/PC-DOS) noted here, and to all those who contribute to the public domain. Windowing --------- Some of the windowing and fast pop/push screen functions were derived from a program called WINDOW.LBR, by R. McVay. I modified it considerably to make it much faster, by customizing it for the IBM PC color/graphics adapter. Directory Listing ----------------- The basic directory function is a "C" translation of DIRSRCH.PAS by Jim Holtman. ZIP's version adds sorting and fast display capabilities. While ZIP is running, assuming enough memory is available, it maintains the complete directory listing in memory. Squeeze/Unsqueeze ----------------- The squeeze and unsqueeze functions are based on Richard Greenlaw's "C" versions. Library (LBR) Functions ----------------------- The library functions are based on various assembler versions written originally by Vernon Buerg, but mostly on Tom Jennings' LU.C. Command/File Execution ---------------------- ZIP uses the DeSmet built-in EXEC function. I've added a shell around this, to search for COMMAND.COM. Unfortunately, at the present time, DeSmet C does not allow me to read the DOS environment directly (which indicate what COMMAND.COM DOS thinks should be used). Telecommunications ------------------ ZIP-TERM, ZIP's telecommunications, is based on earlier work done by a number of individuals, including Alan Bishop. The bulk of ZIP-TERM is based on Phillip R. Burns' PIBTERM of January, 1985. Mr. Burns designed an Xmodem protocol in Turbo Pascal, which was adapted and heavily modified (i.e., optimized); he also provided the Xmodem/CRC methodology also. PIBTERM also provided a VT-52 emulation, which is rather neat. The windowing, command set used in ZIP-TERM, and ZIP interfaces are solely E. Dong's. The basic asynchronous communciations interrupt handler routines are based on a set of Lattice C callable functions to support interrupt driven character I/O on the IBM PC, originally written by Curt Klinsing, which I converted to DeSmet C v2.3. The following notes are mine. All data is in the code segment, since ASM88 (DeSmet assembler) doesn't allow multiple segments other than DSEG and CSEG. Attempts to put data into DSEG fail to work, because there is no way of setting the DS register properly via ASM88. Other ZIP Functions ------------------- All other functions are solely the creation of the author, Edward V Dong. These are: o Change Directory function. o Screen Edit function (C and Pascal versions only). o Hex dump function (C versions only). o Full-screen Browse/View function. o Fast disk access. o Copy/Delete/Print function. plus, of course, the total integration package that ZIP represents.